
--------------------------------------------------------
BeamPRO v3.2:            Batch-beaming anything utility
by Ecamm Network         12/31/03
App Home Page: http://www.ecamm.com/palm/beampro
Credit Card Registration: http://www.ecamm.com/palm/beampro

Executable and Documentation Copyright (c)2003 by Ecamm Network.  All rights reserved.

Handheld RAM Usage: 90K

Features:

 -Infrared beam or Bluetooth transfer to Palm, PocketPC, cell-phone or desktop PC.
 -Batch-beam any files and databases in main memory or expansion card.
 -Beam non-Palm files from expansion cards.
 -Beam multiple Datebook appointments.
 -Beam multiple Address contacts.
 -Beam multiple Memo items.
 -Beam directly to another Palm device's expansion card.
 -Beam non-Palm files such as .txt to registered programs.
 -Cache last used Bluetooth device address. (Skips the discovery phase.)
 -Powerful database category filtering.
 -Batch-delete Palm files and files located on expansion cards.
 -Maintain category info when beaming Address and Memo records to other Palms.
 -Automatically prevents adding duplicate Address and Datebook records on other Palms.
 -Easy interface, just check boxes.

Description:

BeamPRO is a powerful solution for sending multiple files, Address contacts, Memos, and Datebook appointments to another Palm, expansion card, cellphone, Pocket PC, or desktop computer using the infrared beaming or Bluetooth capability of the Palm.

The built-in Palm beaming function only allows the beaming of regular programs.  BeamPRO allows you to beam any type file, such as a data file, e-book, or HackMaster hack, or non-Palm file.  It also allows you to send multiple files in one beaming operation.  Another unique feature of BeamPRO is that there is no need for BeamPRO to be on both handheld devices!  Immediate beaming is possible to any other device.

If you have an expansion card, BeamPRO will allow any files on the expansion card to be included in the transfer.

The interfaces allows the beaming of multiple files, databases, addresses, memo, and Datebook appointments in a single beaming transfer.  The incoming files can be automatically saved on the receiving Palm's expansion card or imported into various Palm programs.

As an added feature, BeamPRO can be used to view and delete Palm files and expansion card files, even if they do not show up in the Palm's built-in deletion screen.

Installing BeamPRO:

Install BeamPRO as you would a regular Palm program.  You should refer to your Palm User's Guide for information on installing Palm programs.

Using BeamPRO:

BEAMING:

Before infrared beaming, ensure that the receiving Palm's "Beam Receive" option is turned on in the Palm's "Prefs" program.  To access this setting, open the program called "Prefs", and use the top-right pop-up menu to choose "General".  The "Beam Receive" option is located at the bottom of the screen.

If you intend to beam Address records, you should ensure that the receive Palm device's Address program is not active.  Likewise, if you intend to beam Datebook records, you should ensure that the receiving Palm device's Datebook program is not active.

BeamPRO's main screen provides four tabs of beaming choices.  The first tab is a list of all databases present on your device's main memory and expansion cards.  (All programs and data are referred to as databases.)  Items with a padlock indicator are copy-protected and cannot be beamed.  An expansion card icon will indicate databases stored on a expansion card.  A computer-chip icon will indicate a ROM-based, Flash memory-based, or read-only database.

The other tabs allow for access to all Memo, Datebook and Address records.

The category selector can be used to show only a specific type of database, distinguished by Palm OS database "type".  For example, you may view all executable PRC programs, all hack modules, all E-Books/Doc Files or all Palm VII PQA modules.

As an added feature, the "Name Filter" category allows you to view all databases containing a particular word, phrase, or series of letter.  The "Type Filter" category allows you to view one Palm file type.  The "Creator ID Filter" category will filter by application creator ID.  The "Selected" category displays all databases that have been selected for transfer.  "Last Beamed" shows the items that were last beamed.  If an expansion card is present, there will be a category to show only those items located on the card.

The "Favorites" category is a customizable category for your most frequently beamed items.  You can add to the category by selecting items and choosing "Add To Favorites" from the dropdown menu.  To remove favorites, choose the "Favorites" category, select items, and choose "Remove From Favorites".  Note that expansion card files cannot be added to "Favorites".

Items in the database list and address list can be found quickly by entering the first letter of the desired entry using graffiti.

Choose items to beam by tapping list items to place checkboxes in the left-hand column.  The size of each database in kilobytes is listed to the right of the name.  As you choose items, BeamPRO will indicate how much data can be beamed in one beaming operation, based on Palm's available memory.  A transfer requires free memory about twice the size of the selected items.  When the Beam Buffer reaches 100%, you have reached your maximum.

As items are selected, the tab labels will indicate the number of items selected.  "Select All" and "Deselect All" are available in the dropdown menus.  "Select All" will select all databases in the current tab/category.  "Deselect All" will deselect all databases in all categories for the current tab.

Select "Palm" or "Other" based on your destination device.  Other includes any PocketPC, Windows PC, cell-phone, or Mac that support "OBEX push" via infrared or Bluetooth.  To send Address and Datebook items, the receiving device must support "vObjects" (vCard and vCal format).  Memo items will be beamed as text files.  Note that if you choose "Other", the duplicate-protection feature will not function.  Furthermore, you can only include items from one tab.

NOTE: When using the "Other" mode to beam multiple files or multiple memo items, the files will be transferred as a MIME encoded list of attachments.  This .mim file will open using WinZip on a Windows PC and Stuffit Expander on a Mac.

If your Palm device is Bluetooth enabled, a popup list will allow for choosing between infrared and bluetooth transfer.  The last used Bluetooth destination will also show up in this list.

To initiate the transfer, line up the infrared ports on the two Palms and tap "Beam" to send the items.  All selected database files, addresses and appointment records will be transfered.  After the transfer is complete, the receiving Palm device will install each of the selected items, and may consult the user if database files with the same name already exist.  Address category information will be preserved on the receiving Palm device.

If the receiving Palm device detects an expansion card, the user will be given the option of saving the files on the card.  Note that if the files are of a type that cannot be saved to main memory, they will automatically be saved to the card.

DELETING:

To delete databases, mark the databases with checkboxes and tap the "Delete" button.  Use caution when deleting databases that you do not recognize.  The Palm uses many hidden files which may contain important information.

Before deleting large amounts of files, the "Selected Items" category can be used to ensure that only the intended files are selected.

Datebook and Address records cannot be deleted with BeamPRO.

PREFERENCES:

The "General Prefs" screen is accessed from the dropdown menu, and lets you configure the following options:

1) You may choose to show/hide system files in the list by choosing "Hide System Databases".  This includes read-only databases (appearing with a computer chip icon) and Palm OS 5 "a68k" system files.  NOTE: This option must be activated to show items in flash memory.

2) If a file already exists on the receiving Palm device, the user will be asked about replacing it with the incoming file.  Use the "Ask Before Replacing" option to disable the prompt.

3) When a file is saved to a receiving Palm's expansion card, a message wil be displayed indicated the file's new location on the card.  You may use the "Display File Location" checkbox to disable this message.

The "PIM Preferences" screen provides options relating to sending PIM (Personal Information Management) data such as Address and Datebook items:

1) You may choose whether or not to preserve the category of beamed Memo and Address records.  Note, this only applies to sending to other Palm OS devices.

2) You may choose whether BeamPRO automatically prevents duplicate Address and Datebook records from being added to the receiving Palm device.  Note, this only applies to sending to other Palm OS devices.

3) BeamPRO provides to option to swap the first and last name fields when sending Address items to non-Palm devices.  This is useful for sending Address items to some Nokia phones.

The "Expansion Card Prefs" screen provides options for sending files to and from an expansion card:

"Look In This Directory":  You can specify the expansion card directory that shows up in BeamPRO.

"Look In Sub-Directories":  If selected, BeamPRO will scan all sub-directories in the specified directory.  For example, if "/" is specified, BeamPRO will scan all directories on the expansion card.  NOTE: You may choose to de-activate this option if BeamPRO is slow to open due to the expansion card having thousands of files and/or sub-directories.

"On Receiving Palm":  If a file is sent to a Palm device, and if it is possible to save it to main memory or an expansion card, the user will be asked about the appropriate desitination.   Use these options to specify a distination, and avoid being asked.  Note that some files can only be saved on an expansion card, and you will never be asked about these files.

Statistics:

BeamPRO displays statistics about infrared/Bluetooth transfer history.

Shareware Notice:

BeamPRO is shareware.  After evaluating BeamPRO, if you decide to keep it, please register the program by paying a US$8.00 shareware fee.  As a registered user, you will be provided with version updates via e-mail.  Registering is easy, and will only take about five minutes!

Ways To Register:

    -Online: Use your favorite credit card to register online:
     http://www.ecamm.com
	You will instantly be provided with a registered version.

    -As an alternative to credit card registration, please contact Ecamm Network via e-mail at sales@ecamm.com, and we'll provide an address where you can mail a check, cash, or money order.

There are so many ways to register, and it's so easy!  Just thought I'd point that out....

Compatibility/System Requirements:

BeamPRO is compatible with Palm OS 3.0 or later.  This includes Palm OS 5.  (Earlier models do not have an infrared port or Bluetooth support, so this shouldn't be an issue.)  Beaming Address and Datebook items to non-Palm devices requires Palm OS 4 or higher.

BeamPRO is incompatible with !pZip v1.1.  This conflict may be corrected in later versions of !pZip.

Modification History:

12/31/03 - v3.2:  Adds ability to replace existing open databases, for example Palm's DIA compatibility PRCs.  Adds a new option to swap first and last name in vCards for beaming to certain phones, including the Nokia 6610.  Beaming an application will now bring the receiving device to the appropriate main menu category, instead of "Unfiled".  Brings back the "Expansion Card" category filter, which disappeared in v3.0.  Removes a limitation that would only display 100 appointments in the month-view.  Fixes a screen redrawing problem visible on the Tungsten T3 with DIA compatiblity PRCs.  Fixes a problem where certain non-computer devices, such as the Ericsson T610, would not show up in some new Palm's Bluetooth discovery window.  Changes default expansion card settings to scan the entire expansion card.  Please send all comments or problems to support@ecamm.com.

9/8/03 - v3.1:  Changes default expansion card settings.  Adds pop-up list of commonly used expansion card directories.  Fixes an issue where beaming Addresses, Datebook items, and Memos did not work in some configurations.  Corrects a major problem with the "Prevent Duplicates" feature.  Fixes a problem where BeamPRO would malfunction when more than 700 files are present.  Fixes a possible crash when beaming to expansion cards with volume names in Palm OS 5.  Fixes a possible crash when beaming card files that don't have a file extension.  "Name Filter" feature now works properly for expansion card files.

7/16/03 - v3.0:  Adds support for sending Address items and Datebook items in vObject format for compatibility with most mobile phones and PocketPC devices.  Adds support for beaming memos and files in OBEX and multi-part MIME format for beaming to non-Palm devices such as PCs, Macs, PocketPCs and mobile phones.  Adds support for beaming non-Palm files located on expansion cards.  Adds support for beaming directly to another Palm's expansion card or directly to applications registered to receive a particular file type.  Adds configuration option for choosing root path for expansion card and support for sub-directories.  Adds support for batch-deleting files on expansion cards.  Adds preference to toggle "Replace Existing" message.  Receiver only shows "Replace All" button if there are multiple items.  Fixes a problem where Bluetooth discovery on Sony Clie devices may not discover anything.  Fixes broken "Creator ID" filter feature.  Fixes an issue with keystroke searching of file list when special characters are present.  Fixes a problem where an error message could refer to the wrong file.  Fixes a problem which could cause cached device names to be truncated when using multiple Bluetooth recipients.

2/16/03 - v2.1.2:  Corrects an issue with the "Replace All" feature when receiving data. 

1/25/03 - v2.1.1:  Fixed a problem caused by a Palm OS bug that would result in some PDB files not being transferred when the receiving device's OS version is below Palm OS 4.

1/20/03 - v2.1:  Added Bluetooth support for sending multiple files, Datebook, Address, and Memo items between Bluetooth enabled Palm OS devices.  Fixed issues with screen refresh when inserting/removing expansion cards.  Fixed a problem that would occasionally result in a crash when receiving data under Palm OS 5.  Fixed a problem with beaming large files from an expansion card, which would result in corrupted or missing files.  Changed "Hide Read-Only DBs" preference to "Hide System Databases", which will now also hide Palm OS 5 "a68k" files.  Added warning message before required reset.  Added Palm OS 5 hi-res icon.  

10/07/02 - v2.0:  Added Memo beaming.  Added month-view to appointment beaming.  Added beaming statistics.  Added support for beaming from HandEra and TRGPro expansion cards.  Added support for beaming from MemPlug expansion cards.  Fixed problem with queuing newly received alarms.  Fixed Address mode keystroke searching. 

6/18/01 - v1.3.1: Fixed expansion card scanning mechanism to support long file names.  Added support for showing Address records with a company name but no first name or last name.  Added transparency to color icons.

6/11/01 - v1.3: Added support for batch beaming Address and DateBook records.  Added support for batch beaming from expansion cards.  Added instant re-beaming of data.  Added "Creator ID Filter" category.  "Type ID Filter" pick-list now displays correctly when type IDs including null characters are present.  Read-only databases and databases stored in flash memory will not arrive on the receiving Palm as read-only databases.  Added small icon for main menu list view.

3/21/01 - v1.2: Add "Selected", and "Doc/E-Book", "Last Beamed", and "Favorites" categories.  Added "Type Filter" feature to view custom file types.  Added color icon.  Increased loading speed.  Expander now honors automatic reset bit, and triggers sysAppLaunchCmdSyncNotify for beamed executable databases.  Fixed a conflict with some JackFlash/JackSafe configurations.  Long file names are now ellipsified.  Fixed problem with "Name Filter" under Palm OS 3.0.

1/12/01 - v1.1:  Added categories, size indicators, and beam buffer indicator.  Improved speed of database packaging.  Please report all comments, suggestions, and bug reports at software@ecamm.com.

12/3/00 - v1.0:  Initial public release.
